Developer --> Technical Publications

     


Creating Keychain References

The Keychain Manager provides two functions to create a keychain reference. A keychain reference is a reference to an opaque structure that contains information about the keychain. The Keychain Manager uses a keychain reference to uniquely identify a keychain. The function KCMakeKCRefFromFSSpec enables you to create a keychain reference from a file specification record. The function KCMakeKCRefFromAlias enables you to create a keychainreference from a handle to an alias. You can create an alias from a keychain reference by calling the function KCMakeAliasFromKCRef.

Your application should not assume a keychain is a file, because keychains may be stored on other media (such as a smart card) in future versions of Keychain Manager.

After you are finished with a keychain reference, you should call the function KCReleaseKeychain to dispose of the memory it occupied. On return, KCReleaseKeychain sets the reference to NULL . You should not use it after this.


© 2000 Apple Computer, Inc. (Last Updated 07 April 00)